Skip to content

Polish pass - #102

Merged
MrMilenko merged 18 commits into
mainfrom
polish-pass
Nov 20, 2026
Merged

MrMilenko merged 18 commits into
mainfrom
polish-pass

Conversation

@MrMilenko

Copy link
Copy Markdown
Owner

A pass over what's already there: clearer, more consistent, faster, fewer rough edges.

Guide. Settings pages are grouped under headings (Window, Rendering, Emulators, Launchers...), every setting has real help text instead of "Left and right change it", prompts say what A does (Search, Import, Sign In, Launch...), rows that open something have a chevron, a few unclear labels got plain names (Anti-Aliasing, Frame Rate Limit, xemu Hard Disk, Return After a Game), the Welcome screen has a title, backups show readable dates, empty fields and folders explain themselves, and Shortcuts show Cmd on a Mac.

Settings window (F4). Built from the same settings table as the guide, so it can't fall behind again. Adds the Games and Controller tabs and console mode, uses the guide's names, and lines every dropdown up. Fixed the qcow2 path never saving.

Media. The local library rescans on its own, sorts properly and cleans up release style names ("The Matrix (1999)"); videos return to the menu when they end and playlists move on; Media no longer gets stuck after visiting Plex or Jellyfin; empty lists say why; the movie menu drops its dead buttons; music finds albums inside artist folders and reads every song's tags.

Plumbing. Terminal output survives a restart on macOS and Linux, and theseus.log is down from 31 to 11 lines on a cold start with clear prefixes and the home folder as ~.

Performance. When the window is minimized or fully covered the dashboard drops to about 19 fps (CPU from about 10% to 2% on an M4), with animations at the same speed; the audio CD player only starts when a disc plays (8 fewer threads at launch).

Each area was audited with before and after screenshots or measurements, and the merged result passes lint, the macOS build, both Xbox builds and a smoke run. Covered window detection is macOS only; Windows and Linux throttle when minimized or hidden.

A restart from the guide or Ctrl+R swaps in a new copy of the app but keeps the
old log pipe, and nothing was reading it anymore, so the terminal went quiet.
Now the new copy puts the real terminal back first and keeps writing to the
same theseus.log, with a Restarted line in between. Windows is unchanged.
It was hand-built, so newer settings like Console Mode, Start at Login and the
whole Games and Controller pages never showed up. Now each tab draws whatever
the settings table has that it doesn't already draw itself, so it can't fall
behind again. Also fixed the qcow2 path never saving, the clipped Display Mode
label and user folder, and the shortcuts list pointing at things that are gone.
Labels sat above their text boxes, and the Optional Tabs checkboxes wrapped
oddly. The Playlist Maker also sent you to a Settings page that's now called Media.
It now opens with the version and OS, shows paths with your home folder as ~,
and puts the renderer on one line. Dropped the old preview banner, the doubled
ready line, the shader chatter, the Plex client id, and expected misses like
background.xbx, missing launcher folders and an empty save folder. Alerts no
longer leave a stray bell character in the file.
The pages listed settings in file order, so Games mixed emulator paths, Title Maker tabs and launcher toggles, and most rows had a generic "Left and right change it" help line. Each page now reads in captioned blocks, every visible setting has its own help, and a few labels say what they mean (xemu Hard Disk, Anti-Aliasing, Frame Rate Limit, Return After a Game, Ask Each Time).
Most rows said Select whatever they did, and a sign in that was waiting for its code still said Select when A cancels it. The prompt now names the action (Search, Copy, Import, Sign In, Cancel, Restart...), every row that opens a list gets the chevron, and Runs With shows its arrows like Category. MORE no longer sits under the Settings tabs, and the Welcome screen got its title back.
Backups showed raw folder names like 2026-11-20 08.32.44, the keyboard field just said Empty, a folder with nothing in it showed a blank list, and the Mac shortcuts said Ctrl. Backups now read as dates with a line on what restoring does, the keyboard shows a hint, empty folders say so, and the Mac shows Cmd. Also filled in the missing sign out and tool help, and game lists now say where a game came from.
The library only scanned when you set a folder, so new files never showed up and a hand-set folder listed nothing. It now rescans in the background once per run. Movies and shows are sorted, scene names like The.Matrix.1999.1080p read as The Matrix (1999), episodes named Show.S01E01.720p show as Episode 1 instead of the file name, and the meta panel puts one fact per line.
The player keeps the file open at the end, so it never saw the end of the file and sat on the last frame until you pressed B. It now watches for that, which also lets playlists move on to the next item.
Backing out of Plex or Jellyfin skipped the Media list, and after that the Media button did nothing. B now lands on the Media list and the scenes reopen. Also gave empty lists a line saying why, kept the header from running into the count, only show the scroll arrows when there's more, and trimmed the movie menu to Play and Info since the other three did nothing.
A Music folder laid out as Artist/Album came up empty. Albums one level down are soundtracks now. Also fixed song tags and lengths: only the first song per scan got read, and the misses were cached for good.
Minimized, hidden or fully covered, it still drew every refresh, about 10% CPU on the Mac. Now it draws around 20 times a second until it's visible again; the clock is real time, so animations keep their speed. Covered only works on macOS so far.
Every launch made an idle mpv player with its scripts just in case. Now it's made on the first track, which drops about eight idle threads. Needs a test with a real audio CD.
Anti-Aliasing and Frame Rate Limit match the guide now, and the label column is wide enough that every dropdown sits in one line.
@MrMilenko
MrMilenko merged commit 83813b3 into main Nov 20, 2026
5 checks passed
@MrMilenko
MrMilenko deleted the polish-pass branch November 20, 2026 14:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant